home *** CD-ROM | disk | FTP | other *** search
/ SysOp's Arsenal / SysOp's Arsenal 1 (Arsenal Computer).ISO / cd_rom / ez-help.txt < prev    next >
Text File  |  1994-10-30  |  10KB  |  201 lines
  1.  
  2.       *** Troubleshooting the EZ-ROM CD-ROM Door by Mike Robinson ***
  3.           October 9, 1994  (This document also applies to the SF-ROM Door)
  4.  
  5.       EZ-ROM writes error conditions to file ERROR.LOG in the current
  6.       directory. Check this file. If it says that EZ-ROM cannot find or
  7.       read a certain file, check your EZROM.MAS and EZROM.CFG files to
  8.       locate where this file is specified. Change the path to the file, or
  9.       relocate the file. Check the spelling of the path and filename
  10.       carefully. A single misplaced character will cause an error.
  11.       Verify that the directories and files specified actually do exist.
  12.  
  13. ------------------------------------------------------------------------------
  14.  
  15.       *** PROBLEM: EZ-ROM works on local end but the caller sees nothing. ***
  16.  
  17.       This is caused by a failure to open the com port. The wrong port is
  18.       being used, the port is non-standard, or there is a conflict with
  19.       other hardware or software. EZ-ROM determines the port number to use
  20.       by reading the door drop file:
  21.  
  22.       DOOR.SYS       com port number is on line number 1  (EZ-ROM)
  23.       DORINFOx.DEF   com port number is on line number 4  (EZ-ROM)
  24.       SFFILE.DAT     com port number is on line number 6  (SF-ROM)
  25.  
  26.       In the batch file that runs EZ-ROM, the first parameter on the
  27.       command line should be the full path and file name of one of these
  28.       files. Check the door drop file to be sure that the correct com port
  29.       number is specified on the indicated file line. You can also force it
  30.       to use a certain port by using the ForceComPort command in EZROM.MAS.
  31.       This will override the port specified in the door drop file.
  32.  
  33.       If EZ-ROM starts, shows some of the initial displays, and then seems
  34.       to halt, this is almost always an IRQ conflict with another device or
  35.       software on the system. The most common such problem is an internal
  36.       modem and IO card trying to use the same IRQ number. Make sure that
  37.       nothing else on your system is using the IRQ and IO base address used
  38.       by EZ-ROM. Other devices which could cause conflicts are a mouse,
  39.       sound card, CD-ROM card, network card, tape backup card, scanner
  40.       card, or just about any other piece of "extra" hardware plugged into
  41.       the computer.
  42.  
  43.       SF-ROM uses the same IRQ and IO address as the Spitfire node. It
  44.       automatically reads this information from the Spitfire SFNODE.DAT
  45.       file.
  46.  
  47.       EZ-ROM uses the "standard" IBM PC clone com port settings which are:
  48.  
  49.       COM1   IRQ 4   $03F8
  50.       COM2   IRQ 3   $02F8
  51.       COM3   IRQ 4   $03E8
  52.       COM4   IRQ 3   $02E8
  53.  
  54.       If your com port does not use these settings, then it is called
  55.       non-standard. Which means that EZ-ROM does not know the correct
  56.       settings, so you must "tell" EZ-ROM which settings to use. The
  57.       commands to do this are:
  58.  
  59.       ForceComPort  2
  60.       ForceIrq  3
  61.       ForceBase  $02F8
  62.  
  63.       Put these commands in either EZROM.MAS (multi-disk mode) or in
  64.       EZROM.CFG (single-disk mode). The settings shown above are for a
  65.       standard COM2. You will have to adjust these to match the settings
  66.       used on your com port. Note the $ in front of number in the ForceBase
  67.       command. This $ indicates that it is a hexadecimal number (base16).
  68.       Also note that if you use a "true blue" IBM PS/2 made by IBM then
  69.       EZ-ROM detects the PS/2 and uses slightly different settings for COM3
  70.       and COM4 only.
  71.  
  72.       EZ-ROM will NOT run properly on a serial port board that uses a
  73.       shared IRQ for more than one com port. Most computers use a standard
  74.       serial port board with 2 com ports that do not use a shared IRQ.
  75.       EZ-ROM will work fine on these. The problem of a shared IRQ usually
  76.       only arises on a multi-port board that has 4 or more ports. It should
  77.       also be noted that EZ-ROM will not work on a DigiBoard.
  78.  
  79.       EZ-ROM will not run properly if  FOSSIL driver is used to remap com
  80.       port settings. EZ-ROM will work fine with a FOSSIL and without a
  81.       FOSSIL. But EZ-ROM ignores the FOSSIL. So if the FOSSIL has changed a
  82.       port setting, EZ-ROM will not "know" about the change, so there could
  83.       be problems.
  84.  
  85. ------------------------------------------------------------------------------
  86.  
  87.       *** PROBLEM: Caller attempts to download a file, the download fails. ***
  88.  
  89.       There are 4 common reasons why downloads fail.
  90.  
  91.       1. DSZ.EXE or DSZ.COM is not in the current directory and not on the
  92.          DOS path. The Xmodem, Ymodem, and Zmodem file transfer protocols
  93.          used by EZ-ROM are supplied by the DSZ program from Omen
  94.          Technology Incorporated. The shareware version is fully functional
  95.          and widely available. The current version is available on my BBS
  96.          as DSZ0920.ZIP.
  97.  
  98.       2. The HoldDir directory specified in EZROM.MAS or EZROM.CFG does not
  99.          exist. EZ-ROM creates a list of files to download in the HoldDir
  100.          directory. If the directory does not exist, it cannot create the
  101.          file and the download fails. Check the spelling of the HoldDir
  102.          carefully. If it is incorrect by just 1 character, the download
  103.          will fail.
  104.  
  105.       3. Not enough memory available to run DSZ. You can see how much
  106.          memory is available by looking at the upper right hand corner of
  107.          the EZ-ROM screen. Hopefully there is at least 70K there. Also,
  108.          check to see if there is an ERROR.LOG file created by EZ-ROM. This
  109.          may give a clue. An error 8 during DSZ means not enough memory.
  110.  
  111.          One common way to gain more memory is to swap the BBS out of
  112.          memory before running EZ-ROM. If your BBS cannot do this, the
  113.          widely available shareware program Shroom (Shell Room) by Davis
  114.          Augustine can swap any program out of memory. Available on my BBS
  115.          as SHROM23A.ZIP.
  116.  
  117.       4. Incorrect usage of the Handshake command in EZROM.MAS or
  118.          EZROM.CFG. EZ-ROM automatically uses the lowercase "ha cts"
  119.          command by default. So unless you want to change the handshake, Do
  120.          NOT use a handshake command at all. If you do use it, you must be
  121.          sure that the command is valid. Several people have tried this:
  122.  
  123.          Handshake HA CTS
  124.  
  125.          This is incorrect. DSZ is case-sensitive. If you use this command
  126.          as shown above, the download will fail. Most commands must be
  127.          lower case like this:
  128.  
  129.          Handshake ha cts
  130.  
  131. ------------------------------------------------------------------------------
  132.  
  133.       *** PROBLEM: No tag letters displayed when viewing file lists. ***
  134.  
  135.          See the TagChar command in EZROM.DOC. If a line in a file list has
  136.          a valid TagChar in the correct position, then that line is
  137.          displayed in color and assigned a tag letter. So all you need to
  138.          do is find a character that repeats in the same position on every
  139.          line which has a file name. Then use the TagChar command to
  140.          specify this character and position.
  141.  
  142.          Here are some examples:
  143.  
  144.          TagChar 26 -
  145.  
  146.          Lines which contain a dash(-) at position 26 will be colorized and
  147.          assigned a tag letter. Lines which do NOT contain this character
  148.          at this position are assumed to be header lines or extended
  149.          description lines.
  150.  
  151.          TagChar ALL
  152.  
  153.          Every line will be colorized and assigned a tag letter no matter
  154.          what is on the line.
  155.  
  156. ------------------------------------------------------------------------------
  157.  
  158.       *** PROBLEM: I registered EZ-ROM and now the <D>ownload command no
  159.                    longer appears on the menu and callers cannot download.
  160.  
  161.          The caller is either over his daily download limit or the daily
  162.          download limits are set too low. Now that EZ-ROM is registered it
  163.          is enforcing the daily download limits. It gets these limits from
  164.          DOOR.SYS lines 31 (kilobytes per day) and line 46 (files per day).
  165.          Some BBS systems put a 0 on either of these lines. So EZ-ROM does
  166.          it's job and enforces a limit of 0. These is a solution. See the
  167.          LIMIT command in EZROM.DOC. It will allow you to set your own
  168.          limits in EZROM.MAS or EZROM.CFG. The limits you set with the
  169.          LIMIT command will override the values in DOOR.SYS. If you use
  170.          DORINFOx.DEF then EZ-ROM will use the default limits of 10 files
  171.          and 2000K per day unless you use the LIMIT command.
  172.  
  173. ------------------------------------------------------------------------------
  174.  
  175.       *** PROBLEM: I registered EZ-ROM, but it is not writing a log file
  176.                    of the caller's activities in the door.
  177.  
  178.          Reasons why log may not be written:
  179.  
  180.          1. Program running in local mode. Log not written in local mode.
  181.  
  182.          2. Program not registered.
  183.  
  184.          3. Log OFF command used.
  185.  
  186.          4. LogName command is spelled wrong.
  187.  
  188.          5. LogName command is preceded by a semicolon or it is not all the
  189.             way up against the left margin of EZROM.MAS.
  190.  
  191.          6. The directory specified for the log is spelled wrong and/or
  192.             does not exist.
  193.  
  194.          7. The name of the log file is spelled wrong and/or it is not a
  195.             legal DOS file name.
  196.  
  197.          8. Some other program is deleting the log. TriBBS uses a temporary
  198.             log for each node. After a caller logs off, the temporary log
  199.             is copied to the main log. The temporary log is then deleted.
  200.  
  201.